Skip to content

Latest commit

 

History

History
142 lines (104 loc) · 4.05 KB

nc-parallel-pparallel_set_chip_mode.md

File metadata and controls

142 lines (104 loc) · 4.05 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NC:parallel.PPARALLEL_SET_CHIP_MODE
PPARALLEL_SET_CHIP_MODE (parallel.h)
The PPARALLEL_SET_CHIP_MODE-typed callback routine sets the operating mode of a parallel port. The system-supplied function driver for parallel ports supplies this routine.
parports\pparallel_set_chip_mode.htm
parports
02/15/2018
PPARALLEL_SET_CHIP_MODE callback
(*PPARALLEL_SET_CHIP_MODE), (*PPARALLEL_SET_CHIP_MODE) callback function [Parallel Ports], cisspd_a108ba77-8f01-436e-bc7a-48a74f80ac75.xml, parallel/(*PPARALLEL_SET_CHIP_MODE), parports.pparallel_set_chip_mode
parallel.h
Parallel.h
Desktop
<=DISPATCH_LEVEL
Windows
RILGBATOKEN, *LPRILGBATOKEN
PPARALLEL_SET_CHIP_MODE
parallel/PPARALLEL_SET_CHIP_MODE
APIRef
kbSyntax
UserDefined
parallel.h
PPARALLEL_SET_CHIP_MODE

PPARALLEL_SET_CHIP_MODE callback

-description

The PPARALLEL_SET_CHIP_MODE-typed callback routine sets the operating mode of a parallel port. The system-supplied function driver for parallel ports supplies this routine.

-parameters

-param SetChipContext [in]

Pointer to the device extension of a parallel port's functional device object (FDO).

-param ChipMode [in]

Specifies the operating mode of a parallel port. (For more information about operating modes, see the modes that are defined for the enhanced capabilities register (ECR) in the parallel.h file that is included in the Microsoft Windows Driver Kit [WDK].)

-returns

Return code Description
STATUS_SUCCESS
The specified operating mode was set.
STATUS_INVALID_DEVICE_STATE
The mode is not cleared.
STATUS_NO_SUCH_DEVICE
The specified operating mode is not valid.

-prototype

typedef NTSTATUS (*PPARALLEL_SET_CHIP_MODE)(
  _In_ PVOID SetChipContext,
  _In_ UCHAR ChipMode
);

-remarks

To obtain a pointer to the system-supplied PPARALLEL_SET_CHIP_MODE callback, a kernel-mode driver uses an IOCTL_INTERNAL_GET_PARALLEL_PNP_INFO request, which returns a PARALLEL_PNP_INFORMATION structure. The TrySetChipMode member of the PARALLEL_PNP_INFORMATION structure is a pointer to this callback.

A caller uses the PPARALLEL_SET_CHIP_MODE callback in conjunction with the PPARALLEL_CLEAR_CHIP_MODE callback.

To set a new mode, a caller must first clear the current mode.

For more information, see Setting and Clearing the Communication Mode on a ParallelPort.

-see-also

IOCTL_INTERNAL_PARALLEL_SET_CHIP_MODE

IOCTL_INTERNAL_GET_PARALLEL_PORT_INFO

PARALLEL_PNP_INFORMATION

IOCTL_INTERNAL_PARALLEL_CLEAR_CHIP_MODE

PPARALLEL_CLEAR_CHIP_MODE